日志记录示例

Visual Basic 提供两种不同的日志记录机制。My.Application.Log 提供对操作系统事件日志的访问，也使您可以将消息写入文本文件。EventLog 组件提供对操作系统事件日志的访问。EventLog 组件使您可以添加和删除日志、添加和移除事件日志源、写入消息以及删除消息。有关示例代码，请参见“事件日志示例”。

若要获取示例和示例的安装说明，请参见下文：

  • 在 Visual Studio“帮助”菜单上单击“示例”。

    有关更多信息，请参见定位示例文件。

  • 示例的最新版本和完整列表可以从 Visual Studio 2008 示例网站获取。

  • 还可以在计算机的硬盘上查找示例。默认情况下，示例和自述文件将复制到 \Program Files\Visual Studio 9\Samples\ 下的一个文件夹中。对于 Visual Studio 速成版，所有示例都位于 Internet 上。

运行此示例

  1. 按 F5。主窗体列出为示例配置的侦听器。

  2. 在窗体上的 TextBox 控件中编写一条消息。

  3. 单击“写入日志消息”按钮。

    消息被写入到各个侦听器。

    1. 由 XmlWriterTraceListener 编写的 XML 文件位于 c:\logsamples\SampleLog.xml 中。

    2. 由 FileLogTraceListener 编写的纯文本文件位于您的“Application Data”目录中。如果您在 Visual Studio 中运行程序，则路径类似于“c:\Documents And Settings\[用户]\Application Data\Microsoft Corporation\Microsoft Visual Studio\[8.0*]\LogSample.log”。

演示

此示例包含：

  • Form1   提供一个简单的窗体，该窗体显示当前为 My.Application.Log 启用的所有侦听器，并具有允许将文本写入 My.Application.Log 的控件。

  • app.config   定义 My.Application.Log 的配置 - 应将消息写到哪里，应筛选哪些消息等等。

此示例演示如何使用 My.Application.Log 来编写纯文本文件、事件日志和 XML 文件。您可以轻松地实现自定义 TraceListener，以写入到其他位置，例如数据库或电子邮件。

每条消息都分配了窗体上选定的“严重度”。当侦听器收到消息时，它可以根据其筛选级别丢弃消息。例如，EventLogTraceListener 组件配置为只写入错误消息，因此您编写的任何具有“信息”或“警告”严重度的消息都将写入到 XML 和纯文本文件，而不是写入 EventLog。

若要更改示例的行为，请编辑项目的 app.config 文件。文件中的注释用作进行更改的指南。

您可以使用 My.Application.Log 和应用程序模型来记录启动、关机和未处理的异常。若要查看本示例的代码，请双击“解决方案资源管理器”中“我的项目”。在“应用程序”窗格上单击“查看代码”按钮。